home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / earcd / mus / play / clips.lha / Clips.doc < prev    next >
Text File  |  1997-01-20  |  3KB  |  96 lines
  1.                        Clips  -  CLI PlaySID 0.07
  2.  
  3.                            19th January 1997
  4.  
  5.  
  6. Clips is a quick util I wrote for playing PlaySID 3.0 songfiles from a
  7. shell or similar.
  8.  
  9. It requires the `playsid.library' for the play routine.  It also uses
  10. `xpkmaster.library' for loading the files.  This allows you to crunch
  11. your songfiles.
  12.  
  13.  
  14.              ----------------------------------------------
  15. Usage
  16. ~~~~~
  17. Clips <song>
  18.   This will play the selected file.  There is no reporting of errors if
  19.   something goes wrong.  If the file is not a valid songfile, Clips will
  20.   simply exit out.
  21.  
  22.   Clips does not detach from the CLI, so if you want to change things,
  23.   you will either need to runback it, or use a different shell.
  24.  
  25.   If you launch Clips with a valid songfile while one is playing, the
  26.   original will stop, and the new one will start playing.  This can be
  27.   quite useful for use with something like DirectoryOpus.
  28.  
  29.   You can abort Clips at anytime with CTRL-C.
  30.  
  31.  
  32. Clips CHANGE      - `reqtools.library' is required for this function
  33.  
  34.   This will bring up a ReqTools number requester.  It will show you what
  35.   range of sub-songs are available.  Simply type the number of the
  36.   sub-song you wish to listen to.
  37.  
  38.   If there is only one song in the file, then the song will simply be
  39.   restarted if you use this option.  No requester will appear.
  40.  
  41.  
  42. Clips NEXT
  43.  
  44.   This advances to the next sub-song.  If there are no more tracks, then
  45.   it loops back to the first.  If there is only one song in the file
  46.   then the track will re-start.
  47.  
  48.  
  49. Clips STOP
  50.  
  51.   This simply stops the currently playing song, and causes the orignal
  52.   Clips to exit.
  53.  
  54.  
  55.              ----------------------------------------------
  56. History
  57. ~~~~~~~
  58.  0.05        - Initial Release
  59.  
  60.  0.06        - Added NEXT option
  61.  
  62.  
  63.              ----------------------------------------------
  64. Notes
  65. ~~~~~
  66. #include <std_disclaimer.h>
  67.  
  68. I am very bad at writing documentation for my programs.  I know how
  69. they work because I wrote them.  Putting how they work into words
  70. is something I have always found difficult.
  71.  
  72. Clips is Public Domain.  Do want you want with it.  I take no
  73. responsibility for what happens.  If you change the source, and
  74. re-release it, please remove my name from the distribution.
  75.  
  76. It's probably very dangerously coded, but I haven't had it crash yet.
  77.  
  78.  
  79. If you have any problems, please feel free to contact me.
  80.  
  81.  
  82. Special thanks to:
  83.    Kerry          - For putting up with me (Love ya)
  84.    Renze          - For not caring
  85.    Rudolph Riedel - Suggestion and interest
  86.  
  87.  
  88.              ----------------------------------------------
  89. Contact
  90. ~~~~~~~
  91.    Dave Dustin                     Ph/Fax: +64-6-357-9283
  92.    Eclipse Software                Email:  dave@eclipsnz.manawatu.gen.nz
  93.    PO Box 4598
  94.    Palmerston North  5301
  95.    New Zealand
  96.